Add Clusters view to Agent Network → Configuration by braginini · Pull Request #714 · netbirdio/dashboard

braginini · 2026-07-15T18:46:56Z

Issue ticket number and link

Surfaces reverse-proxy Clusters inside the Agent Network focused view, where the full Reverse Proxy menu is hidden.

Adds a third Clusters tab to the Agent Network → Configuration page (/agent-network/configuration?tab=clusters), alongside Global Limits and Log Collection.
Reuses the existing self-contained ClustersTable (lazy-loaded), so cluster listing and self-hosted cluster setup work with no extra data-provider plumbing.
Gated by the page's existing services.read permission; available in both cloud and self-hosted.
The tab description adapts to context: agent-network-only accounts get an agent-focused blurb ("Proxy clusters route your agents' traffic to AI providers…"), everyone else keeps the standard reverse-proxy wording.

Single file changed: src/app/(dashboard)/agent-network/configuration/page.tsx (+36/−2).

Note: the onboarding "create a cluster" step is intentionally out of scope and deferred to a follow-up.

Documentation

Select exactly one:

I added/updated documentation for this change
Documentation is not needed for this change (explain why)

Docs PR URL (required if "docs added" is checked)

Paste the PR link from https://github.com/netbirdio/docs here:

netbirdio/docs#856

E2E tests

Optional: override the image tags used by the Playwright e2e workflow.
Defaults to main when omitted.

management-cloud-tag: main
reverse-proxy-tag: main

^{Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.}

Summary by CodeRabbit

New Features
- Added a Clusters tab to Agent Network Configuration.
- Added a clusters table with loading feedback.
- Included contextual guidance and a “Learn more” link for cluster configuration.

coderabbitai · 2026-07-15T18:47:37Z

📝 Walkthrough

Walkthrough

The agent network configuration page adds a Clusters tab with mode-aware explanatory text, a documentation link, and a lazily loaded clusters table using a skeleton fallback.

Changes

Agent Network Clusters

Layer / File(s)	Summary
Clusters tab and content flow `src/app/(dashboard)/agent-network/configuration/page.tsx`	Adds the Clusters tab, resolves agent network mode, links to reverse-proxy cluster documentation, and renders `ClustersTable` through `Suspense` with `SkeletonTable`.

Estimated code review effort: 2 (Simple) | ~10 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant AgentNetworkConfigurationPage
  participant ClustersTable
  User->>AgentNetworkConfigurationPage: Selects Clusters tab
  AgentNetworkConfigurationPage->>AgentNetworkConfigurationPage: Renders mode-aware header and documentation link
  AgentNetworkConfigurationPage->>ClustersTable: Lazy-loads clusters table

Possibly related PRs

netbirdio/dashboard#708: Introduces the agent network mode resolution used for conditional Clusters content.

Poem

A rabbit hopped through tabs so bright,
And found Clusters waiting in sight.
With docs to read and tables to load,
A skeleton paved the loading road.
“Hop hooray!” the network glowed.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title is concise and accurately summarizes the main change: adding the Clusters view to Agent Network configuration.
Description check	✅ Passed	The description follows the template well and includes docs and e2e details; the issue ticket section is the only gap.

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch feature/agent-network-cluster

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

mlsmaycon

pending docs URL

…tbirdio#717 并汉化 - merge netbirdio/main: Agent Network clusters/RDP/features 更新 - 新增 14 个翻译 key (配置页/Agent Network 通知/RDP 弹窗) - agent-network/configuration page 全面汉化 - RDPCredentialsModal 全面汉化 - NetBirdCloudProvider toast 汉化

This PR contains the following updates: | Package | Update | Change | |---|---|---| | [netbirdio/dashboard](https://github.com/netbirdio/dashboard) | minor | `v2.90.4` → `v2.92.0` | | netbirdio/netbird | minor | `v0.74.6-rootless` → `0.78.1-rootless` | | netbirdio/netbird-server | minor | `0.74.6` → `0.78.1` | | netbirdio/reverse-proxy | minor | `0.74.6` → `0.78.1` | --- ### Release Notes <details> <summary>netbirdio/dashboard (netbirdio/dashboard)</summary> ### [`v2.92.0`](https://github.com/netbirdio/dashboard/releases/tag/v2.92.0) [Compare Source](netbirdio/dashboard@v2.91.1...v2.92.0) #### What's Changed - fix(agent-network): show real provider name in access log by [@braginini](https://github.com/braginini) in [#758](netbirdio/dashboard#758) - Show SSH enable commands with the privileges the daemon requires by [@lixmal](https://github.com/lixmal) in [#737](netbirdio/dashboard#737) - fix(setup): match the v0.75 client UI in the management URL step by [@braginini](https://github.com/braginini) in [#765](netbirdio/dashboard#765) - feat: add required Country field to Agent Network signup form by [@SunsetDrifter](https://github.com/SunsetDrifter) in [#766](netbirdio/dashboard#766) - Load a provider's models from the vendor in the provider modal by [@mlsmaycon](https://github.com/mlsmaycon) in [#767](netbirdio/dashboard#767) - Keep the prices discovery returns for a loaded model by [@mlsmaycon](https://github.com/mlsmaycon) in [#773](netbirdio/dashboard#773) - Add a workflow bumping the WASM client on netbird releases by [@lixmal](https://github.com/lixmal) in [#770](netbirdio/dashboard#770) - ci: skip Docker publishing for community PRs by [@jnfrati](https://github.com/jnfrati) in [#775](netbirdio/dashboard#775) - Fix typo in PeerExpirationToggle component by [@bomkz](https://github.com/bomkz) in [#665](netbirdio/dashboard#665) - fix: use --restart=unless-stopped instead of --rm in Docker install command by [@shaban00](https://github.com/shaban00) in [#760](netbirdio/dashboard#760) - Add control center draft mode by [@heisbrot](https://github.com/heisbrot) in [#744](netbirdio/dashboard#744) - Detect Entra connection from auth service SSO connections by [@heisbrot](https://github.com/heisbrot) in [#776](netbirdio/dashboard#776) - Add bulk deletion for Access Control groups by [@TechHutTV](https://github.com/TechHutTV) in [#752](netbirdio/dashboard#752) - Add Agent Network Admin and Usage Viewer roles, gate Agent Network per submodule by [@mlsmaycon](https://github.com/mlsmaycon) in [#764](netbirdio/dashboard#764) - feat(agent-network): add agentgateway provider support by [@danehans](https://github.com/danehans) in [#774](netbirdio/dashboard#774) - fix(e2e): stabilize agentgateway provider test by [@jnfrati](https://github.com/jnfrati) in [#782](netbirdio/dashboard#782) - Keep a refused provider save on screen, and its discovered prices by [@mlsmaycon](https://github.com/mlsmaycon) in [#772](netbirdio/dashboard#772) - Show peer-sourced policies in the Control Center peer view by [@heisbrot](https://github.com/heisbrot) in [#786](netbirdio/dashboard#786) - Pin the group view's group, and give agentgateway a reachable upstream by [@mlsmaycon](https://github.com/mlsmaycon) in [#788](netbirdio/dashboard#788) - Add anonymization level and upload URL to the debug bundle modal by [@mlsmaycon](https://github.com/mlsmaycon) in [#753](netbirdio/dashboard#753) #### New Contributors - [@bomkz](https://github.com/bomkz) made their first contribution in [#665](netbirdio/dashboard#665) - [@shaban00](https://github.com/shaban00) made their first contribution in [#760](netbirdio/dashboard#760) - [@danehans](https://github.com/danehans) made their first contribution in [#774](netbirdio/dashboard#774) **Full Changelog**: <netbirdio/dashboard@v2.91.1...v2.92.0> ### [`v2.91.1`](https://github.com/netbirdio/dashboard/releases/tag/v2.91.1) [Compare Source](netbirdio/dashboard@v2.91.0...v2.91.1) #### What's Changed - fix(version): ignore build metadata when detecting available updates by [@braginini](https://github.com/braginini) in [#759](netbirdio/dashboard#759) **Full Changelog**: <netbirdio/dashboard@v2.91.0...v2.91.1> ### [`v2.91.0`](https://github.com/netbirdio/dashboard/releases/tag/v2.91.0) [Compare Source](netbirdio/dashboard@v2.90.10...v2.91.0) #### What's Changed - Update Entra ID SCIM setup wizard for the new Azure portal UI by [@bcmmbaga](https://github.com/bcmmbaga) in [#750](netbirdio/dashboard#750) - Bootstrap Agent Network settings via the explicit POST by [@bison](https://github.com/bison) in [#746](netbirdio/dashboard#746) - Bump default wasm client to v0.76.3 by [@lixmal](https://github.com/lixmal) in [#754](netbirdio/dashboard#754) - Fix icon alignment in collapsed navigation and network tab Add buttons by [@heisbrot](https://github.com/heisbrot) in [#748](netbirdio/dashboard#748) - Upgrade Next.js to 16.3 by [@heisbrot](https://github.com/heisbrot) in [#755](netbirdio/dashboard#755) - Upgrade base image to Alpine 3.24 by [@heisbrot](https://github.com/heisbrot) in [#756](netbirdio/dashboard#756) #### New Contributors - [@bison](https://github.com/bison) made their first contribution in [#746](netbirdio/dashboard#746) **Full Changelog**: <netbirdio/dashboard@v2.90.10...v2.91.0> ### [`v2.90.10`](https://github.com/netbirdio/dashboard/releases/tag/v2.90.10) [Compare Source](netbirdio/dashboard@v2.90.9...v2.90.10) #### What's Changed - Handle agent-network settings defaults response by [@mlsmaycon](https://github.com/mlsmaycon) in [#739](netbirdio/dashboard#739) - Remove solutions engineer booking modal from onboarding by [@SunsetDrifter](https://github.com/SunsetDrifter) in [#745](netbirdio/dashboard#745) - Trim numeric build suffix from sidebar version display. by [@braginini](https://github.com/braginini) in [#749](netbirdio/dashboard#749) **Full Changelog**: <netbirdio/dashboard@v2.90.9...v2.90.10> ### [`v2.90.9`](https://github.com/netbirdio/dashboard/releases/tag/v2.90.9) [Compare Source](netbirdio/dashboard@v2.90.8...v2.90.9) #### What's Changed - Add openSUSE zypper instructions with GPG key import to the Linux tab by [@pappz](https://github.com/pappz) in [#735](netbirdio/dashboard#735) - Cache pricing + custom model entry by [@braginini](https://github.com/braginini) in [#736](netbirdio/dashboard#736) **Full Changelog**: <netbirdio/dashboard@v2.90.8...v2.90.9> ### [`v2.90.8`](https://github.com/netbirdio/dashboard/releases/tag/v2.90.8) [Compare Source](netbirdio/dashboard@v2.90.7...v2.90.8) #### What's Changed - Show agent-network prompt-cache tokens and cost on hover by [@mlsmaycon](https://github.com/mlsmaycon) in [#731](netbirdio/dashboard#731) - Cover RPM-based distros and desktop app dependencies in the Linux tab by [@mlsmaycon](https://github.com/mlsmaycon) in [#733](netbirdio/dashboard#733) **Full Changelog**: <netbirdio/dashboard@v2.90.7...v2.90.8> ### [`v2.90.7`](https://github.com/netbirdio/dashboard/releases/tag/v2.90.7) [Compare Source](netbirdio/dashboard@v2.90.6...v2.90.7) #### What's Changed - remove rc releases logic for agent networks by [@mlsmaycon](https://github.com/mlsmaycon) in [#725](netbirdio/dashboard#725) - Add 0.75 announcement by [@braginini](https://github.com/braginini) in [#727](netbirdio/dashboard#727) **Full Changelog**: <netbirdio/dashboard@v2.90.6...v2.90.7> ### [`v2.90.6`](https://github.com/netbirdio/dashboard/releases/tag/v2.90.6) [Compare Source](netbirdio/dashboard@v2.90.5...v2.90.6) #### What's Changed - \[agent-network] per-provider disable-metadata toggle by [@mlsmaycon](https://github.com/mlsmaycon) in [#715](netbirdio/dashboard#715) - Add Kimi (Moonshot AI) provider support to Agent Network UI by [@mlsmaycon](https://github.com/mlsmaycon) in [#724](netbirdio/dashboard#724) **Full Changelog**: <netbirdio/dashboard@v2.90.5...v2.90.6> ### [`v2.90.5`](https://github.com/netbirdio/dashboard/releases/tag/v2.90.5) [Compare Source](netbirdio/dashboard@v2.90.4...v2.90.5) #### What's Changed - Show RDP for Linux and FreeBSD peers and harden the browser RDP client by [@lixmal](https://github.com/lixmal) in [#710](netbirdio/dashboard#710) - Add Clusters view to Agent Network → Configuration by [@braginini](https://github.com/braginini) in [#714](netbirdio/dashboard#714) - Fix IdP cards spacing by [@braginini](https://github.com/braginini) in [#717](netbirdio/dashboard#717) - Adjust license cache ttl to 10 minutes by [@mlsmaycon](https://github.com/mlsmaycon) in [#718](netbirdio/dashboard#718) - Fix network resource policy creation with single peer source by [@heisbrot](https://github.com/heisbrot) in [#721](netbirdio/dashboard#721) **Full Changelog**: <netbirdio/dashboard@v2.90.4...v2.90.5> </details> --- ### Configuration 📅 **Schedule**: (UTC) - Branch creation - At any time (no schedule defined) - Automerge - At any time (no schedule defined) 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://github.com/renovatebot/renovate/discussions) if that's undesired. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).  Reviewed-on: https://git.jfreudenberger.de/JuliusFreudenberger/nix-config/pulls/24

Add clusters view to agent network

736adae

mlsmaycon approved these changes Jul 15, 2026

View reviewed changes

braginini merged commit b9569f4 into main Jul 15, 2026
9 of 12 checks passed

braginini deleted the feature/agent-network-cluster branch July 15, 2026 21:22

ocoj pushed a commit to ocoj/dashboard that referenced this pull request Jul 17, 2026

Add clusters view to agent network (netbirdio#714)

01ce746

fosskar Bot mentioned this pull request Jul 21, 2026

netbird-dashboard: 2.90.4 -> 2.90.5 fosskar/nixfiles#205

Merged

coderabbitai Bot mentioned this pull request Aug 16, 2026

Add Agent Network Admin and Usage Viewer roles, gate Agent Network per submodule #764

Merged

2 tasks

ocoj pushed a commit to ocoj/dashboard that referenced this pull request Aug 16, 2026

Add clusters view to agent network (netbirdio#714)

d9ee418

Navigation Menu

Uh oh!

Add Clusters view to Agent Network → Configuration - #714

Add Clusters view to Agent Network → Configuration#714
braginini merged 1 commit into
mainfrom
feature/agent-network-cluster

braginini commented Jul 15, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 15, 2026 •

edited

Loading

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

mlsmaycon left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

braginini commented Jul 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue ticket number and link

Documentation

Docs PR URL (required if "docs added" is checked)

E2E tests

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Jul 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

mlsmaycon left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

braginini commented Jul 15, 2026 •

edited

Loading

coderabbitai Bot commented Jul 15, 2026 •

edited

Loading